home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / PowerPlant / AGA Slider 1.0 / Read Me < prev   
Text File  |  1996-06-25  |  4KB  |  106 lines
  1. AGA Slider:    A demo of class CAGASlider v 1.0                        June 25, 1996
  2.     68K
  3.     CodeWarrior 9
  4.     PowerPlant
  5.  
  6. ================================================================================
  7.  
  8. AGA Slider is a project for demonstrating the CAGASlider class.
  9.  
  10. CAGASlider is a PowerPlant LControl that looks like a slider from
  11. the Apple Grayscale Appearance for System 7. It is not a CDEF.
  12.  
  13. Apple's docs on the AGA show you what things look like to the pixel,
  14. but, alas, they don't explain behaviors. I had to guess, mostly by 
  15. imitating the slider in the Sound control panel.
  16.  
  17. Feel free to send me any comments, suggestions, and bug-reports at:
  18.   jennings@halycon.com (James Jennings)
  19.  
  20. CAGASlider is copyright © 1996 by James Jennings. All rights reserved.
  21. You may freely use it for non-commercial projects and inexpensive shareware.
  22.  
  23. ================================================================================
  24.  
  25. Features of CAGASlider:
  26.  
  27.     Mouse down in the indicator shows a "pressed" indicator.
  28.     As indicator is dragged, the pressed indicator doesn't move and a "ghost" 
  29.         indicator follows the mouse.
  30.     The ghost indicator disappears when it's over the pressed indicator.
  31.     Clicking on the "track" jumps the indicator to that position.
  32.     When the mouse is released, the real indicator moves to the ghost's last position.
  33.     When the mouse is dragged away from the track, the ghost disappears. (Aborting.)
  34.     Horizontal and vertical sliders are centered in the pane. (Needs >=16 pixel width.)
  35.     "Pointing" sliders (which have tick marks) are aligned to the side of the pane away 
  36.         from the pointer and the tick marks. (Needs >=25 pixel width.)
  37.     Sliders are drawn correctly when Disabled().
  38.     Uses StOffscreenGWorld for flicker-free tracking.
  39.     Looks reasonable on black and white screens.
  40.     Looks reasonable when split across two monitors of different pixel depths. (Although,
  41.         since I only have one monitor myself, this hasn't been tested as much as I'd like.)
  42.  
  43. Limitations:
  44.     Doesn't have value labels. If you add your own (with an LCaption, say)
  45.     be sure to gray them out when the CAGASlider is disabled.
  46.  
  47. ================================================================================
  48.  
  49. CAGASlider's CPPb resource (for Constructor) should define these members:
  50.  
  51.     Direction:    (Int32, viewed as Text)
  52.         Values: hori, vert, nort, sout, east, west, prop
  53.         Chooses the indicator type. 
  54.         nort, sout, east, west refer to the compass direction of "pointy" indicators.
  55.         'prop' chooses hori or vert depending on the pane proportions.
  56.         Note: These values are not stored. They are converted into an enumerated 
  57.             type in the CAGASlider constructor.
  58.     Number of Tick Marks: (Uint16)
  59.         Values:
  60.             0: Don't show tick marks.
  61.             1: Show one tick mark for each allowed value of LControl::mValue.
  62.             n > 1: Show n tick marks (n-1 intervals).
  63.         Note: Number of Tick Marks is ignored for hori and vert types.
  64.     Continuous Broadcast: (Boolean)
  65.         Values:
  66.             false: BroadcastMessage() is called only when the slider is released (on mouseUp).
  67.             true:  BroadcastMessage() is called every time the value changes during a drag.
  68.  
  69. There is also a file called CAGASlider.CPPb which defines CAGASlider for Constructor.
  70. It has been hacked so that the Direction appears as a pop-up menu. 
  71. The best way to use it is to place it in the same folder with Constructor 
  72. so that Constructor (v2.2 or later) will load it on startup.
  73.  
  74. *Note:* Constructor 2.2 cannot edit CAGASlider.CPPb without crashing. 
  75.  
  76. ================================================================================
  77.  
  78. To add CAGASliders to your project:
  79.  
  80.     To a PowerPlant "Starter" project you will need to add the files:
  81.         CAGASlider.cp
  82.         AGA Slider Parts PICTs.rsrc
  83.         UGrayscaleAppearance.cp
  84.         UGWorld.cp
  85.     You will also need:    (in your project folder)
  86.         CAGASlider.h    
  87.         UGrayscaleAppearance.h
  88.     and:    (in Constructor's folder)
  89.         CAGASlider.CPPb
  90.  
  91. ================================================================================
  92.  
  93. Programming Notes:
  94.  
  95. CAGASlider inherits from LControl and UGrayscaleAppearance.
  96.  
  97. UGrayscaleAppearance is a class I wrote to encapsulate the AGA color definitions.
  98. UGrayscaleAppearance.cp also defines some LAttachments that are not used in this project.
  99.  
  100. I set the background color of the Demo's window to gray by setting its "content" color 
  101. in ResEdit. This adds a 'wctb' resource. There is no code in the project that draws 
  102. the background color for the whole window, just for the sliders.
  103.  
  104. James Jennings
  105. jennings@halcyon.com
  106.